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Preface 



Welcome \o iJie world of CP/M®t The CP/AM 5.1^ operating system and the Z- 
SO™ microprocessor on your Applied Engineering® Z-BO Plus"^, Z-Ram™> or Z- 
80c™ will enable you lo njn Uiousands of CP/M based programs on your Apple 
computer. This manual will introduce you to CP/AM 5.1, Applied Engineering's 
version of ihe CP/M operating system. 



About This Manual This manual is not a manual Tor professional programmers, nor is ii a niiorial for 

learning Ihc CP/M operating system. The intent of this guide is to provide you 
with enough infomiaiion about the CP/AM operating system to enable you to mn 
your CP/M based application pipgrams, configure the operating system to suit the 
requirements of your system, and manipulate CP/M files, using the utilities 
provided on Oie CP/AM 5A System Master disk. Here's a summary of what is 
contained in this manual; 



Chapterl An Introduclton lo CP/AM, gives you an overview of the 
CP/AM 5. 1 operating system and explains some of the basic CP/M 
conventions and commands. 



Chapter 2 CP/AM Transienl Commands, explains how to use some of the 
utility resources included on the CP/AM 5.1 System Master disk to 
create and manipulate CP/M disks and fdes. 

Chapters CP/AM System Configuralion, tells you how to customize the 
CP/AM operating system on your disks to suit your needs and ilie 
configuration of your computer system. 

Chapter4 CP/AM Technical Reference, is intended for hard-core CP/M 
backers only. All others please stay away! 

Appendix A Apple® llGS Users, informs IIgs owners what steps particular lo 
the llGS should be taken to make the GS to work with CP/AM. 

Appendix B Wcrdslar and CP/AM, tells you what you need to do before 
running the CP/M based Wordstar word processor program. 

Appendix C Sider^" Hard Disk Support* gives instructions for installing and 
using CP/AM 5, 1 on First Class Peripherars Sidcr hard disk drive. 

Appendix D Further Reading, suggests books about CP/M, Wordstar and the 
Z-ao card that you may find hclptiiL 
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Applied 
Engineering 
Technical Support 



If you have a teclinica] question relating lo an Apphcd Engineering produci. please 
comact the dealer from whom you purchased the product. Most dealers have 
ihe knowledge and the resources to readily answer your question. In the event that 
thcdealercannotansweryourquesiion. direct it to Applied Engineering. We have 
a staff of technicians dedicated to answering specific technical questions about 
Applied Engineering products and software. Technical Suppcirt representatives are 
available between the hoursof 9 AM to 5 PM CST, Monday through Friday. The 
Technical Support telephone number is (214) 241-6069. Please call only iliis 
numtJcr for icchnica] support as our sales office cannot transfer calls lo Ihe support 
lines. 

The support represemaiivcs an; experienced in many of the applications and uses of 
Applied Engineering products, but in order to pnDvide a quick and effective answer 
to your question, they will need to know as much as possible about the hardware 
and software specifically related to your question. Please provide the technical 
support representative with the following infomiaDon: 



• Tlie Applied Engineering produci related to your question. 

- The model and conliguralion of your computer (what peripherals are being 
used). 

■ If the question is related to an Applied Engineering memory expansion card, 
please provide ihe revision level* original memoiy configuration, and current 
memory configuralion of the card. 

■ The name, version, and revision level of the software with which you are 
experiencing problems. 

' The resulLs of any test programs or diagnostics that you may have niTL 

■ The resultsofany troubleshooting done by you or your dealer- 



Most questions can be answered in one telephone conversation, but some may 
require research by the technical support representative. Please be sure to make a 
note of the representative's name just in case you need to call back with any 
additional information or follow-up on a previous question. 



Applied Engineering 
Technical Support 

(214) 241-6069 

9 AM to 5 PM (CST) 

Monday Through Friday 



Rememlxrr 
When all else falls, read ihe instructions! 
,.,lhen call technical support . 
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An Introduction to CP/AM 



About CP/AM 5.1 



Operating System? 



CP/M, which siands for Comrol Program / Moniior. is a very popular operating 
system designed for computers which use tJie Z-SO microprocessor. Your Apple 
computer is based on a 6502 microprocessor, which is why you have installed 
Applied Engineering's Z-SO based co-processor card. CP/AM 5.1 is Applied 
Engineering's version of CP/M and is the disk operating system which allows 
programs wriuen for CP/M to run on the Z-80 equipped Apple computer. 

Your computer is not just a single unit» but several componenls. all of which must 
woiic together as a system. A typical computer system consists of a CPU (cenlral 
processing unit), peripheral inpul/ouipui devices (video monitor, keyboard, disk 
drives, printer), and two equally imporLani components: the application program and 
the operating system. The function of the application program depends on the 
purpose for which it was written, (e.g. word processor, spreadsheet, etc.) The 
primary function of an operating system is to interface the application program 
(software) wilh the CPU and i[s peripheral devices (hardware) and to manage the 
flow of information within ilic computer. The operating system is actuaUy a set of 
standardized programs, called subroutines, which are loaded into a reserved portion 
of the compuicr's memory whenever a system disk is booted. These subroutines 
contain the instructions called upon by the application program to manage and 
coordinate the computer sysiem's routine mput and output activities. 

Programs written for Digital Research CP/M version 2,2, as well as virtually all 
older CP/M programs, will mnunder CP/AM 5.1. CP/AM 5, 1 supersedes CP/AM 
4.0B, the previous version of the operating system. Version 5.1 is completely 
backward compatible wilh and has all of the many features of CP/AM 4,0B. but has 
the following improvements: 

• Full support for peripheral devices which use Apple Computer's Protocol 
Convener, This enables you to create bootable devices on (be UniDisk 3.5^, 
RamFactor™. Apple II Memory Expansion Card, as well as future devices 
which support die Protocol Converter. 

• Improved video screen drivers, which use the computer's video hardware 
rather than program software to send output to the video display. This allows 
faster scrolling and compaiibility with Franklin Ace 2000 series video 
displays. 

■ Full support for First Class Peripheral's Sider hard disk drive. Installation 
utilitiesareprovidedonihe CP/AM 5.1 System Master 
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System Requirements 

Hardware: CP/AM 5,1 was designed for use wiih (he following Applied Engineering Z-80 

products: 

Z-BO Plus Apple IlGS. //e, II, U +, Franklin Ace, and Laser 128 

(Apple IlGS users refer lo Appendix A.) 

Z-RaniUltra3 Apple //c 

Z-Ramn Ar31c//c 

Z-Ram Apple //c 

Z-80c Apple //c 



Memoiy Si/c: CP/AM 5,1 requires a minimum of 64K of Random Access Memory (RAM), if Ihe 
CP/AM operating system is lo be run on an Apple 11, 11+ or Franklin Ace 1000 
series computer which has less ihan 64K of memory, ihe 44K version of CP/AM 
4.0B must be used. This version and iis utiliiies are supplied on ihe back side of ihe 
CP/AM 5-1 System Master disk. The differences between versions 4.0B and 5. 1 
are covered in Chapter 3- 



Video Display: Your computer must be capable of displaying an SO column screen. You should 
have an RO column text card installed in the auxiliary slot of an Apple //e or in slot 3 
of an Apple II, 11+ or Franklin Ace 1000 series computer. The Apple IlGS and //g. 
Laser 128, and Franklin Ace 2000 senes computers have buili-in 80 column text 
cards. Obviously, a video monitor capable of SO colunm display is also required. 
Most monochromatic video monitors are capable of 80 column display. Most TV 
sets, on the other hand, are not. Televisions are only acceptable for programs 
which use a 40 column display. The narrower SO column characters tend lo blur 
and am very difficult lo read when displayed on a TV screen, CP/AM also supports 
RGB interfaces and monitors. 



Mass Storage CP/AM 5,1 supports both the standard 5 1/4 inch floppy disks and the new 3,5 inch 
microfloppy disks (UniDisks). Your computer system should have ai least one 5 
1/4 inch floppy disk drive. The floppy disk interface card must be in slot 6. The 
disk format, or method in which data is stored on the mass storage medium (usually 
floppy disk), varies from one brand of computer lo another. Disks containing 
CP/M programs must be in Apple disk forniaf While most programs written for 
the CP/M operating system are usually compatible with CP/M used on different 
brands of compulen>, the program files must first be converted to the appropriate 
disk format- When selecting CP/M programs, make sure that the disks are in Apple 
compatible fonnat. Some dealers or CP/M oriented users groups may have the 
facihties lo convert programs stored on various media or in different fomiat to a 
compatible Apple fonnai. 
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Before You 
Begin... 



Whatever can go wrong, will go wrong! Make a BACKUP copy of ihc CP/AM 
5.1 Sysiem Mas[er disk. This is not only a good idea, it is required. Some 
CP/AM commands require ihe floppy disk be wrile-cnabled. (The CP/AM 5.1 
System Master has no wriie-enable notch.) Use the following procedure lo make 
die copy: 

Boot the CP/AM 5.1 System Master disk. This message should appear on Uie 
screen: 



APPLE H CP/AM 

60K Ver S.l 

(C) 1986 APPLIED ENGINEERING 

A> 



CP/AM 5.1 
Conventions 



File Names 



Alihis prompt (A>). type the following command if youhaveaiwo-drivc system: 

COPY B:^A: 
If you have a one-drive system type: 

COPY A:=A; 

The directions, displayed on the screen, will prompt you to insert a SOURCE disk, 
which is the original CP/AM 5. 1 Sysiem Master disk, and a DESTINATION disk, 
which is any blank disk with Ihc write-proieci tab removed. For a one-drive copy it 
wiU be necessary to alternately inscn the SOURCE and DESTINATION disks uniU 
the disk is completely copied. Slorc Ihc original CP/AM 5,1 System Master disk in 
a safe place. 

The following is a review of the standard CP/M command and file conventions as 
well as some special notes about CP/AM command syntax used in this chapter. In 
the command examples shown in this text, a carriage return is shown as "<cr> ". 
Control characteni are indicated by preceding die command character with a " ^ " 
(circumflex). The system prompt. "A>", shown at the beginning of the command 
line examples in this manual, is not part of die command. 

In a command expression (command Une). a space is used to scpamtc the command 
from its argument. The space iscritic^il toihe execution of the command sequence, 

CP/AM will accept lower case characters entered from ihc keyboard. For instance, 
a control'C has the same effect as a conin^l-C. Filenames and nieiypc extensions 
entered in lower case are converted to upper case in the disk directory, 

WARNING: Don't press CONTROL-RESET while your CP/M 
program is running! Doing so will cause the computer to reboot! 

CP/AM file names follow Ihe standard CP/M fonnat. A file name can have from 
one to eight primable ASCII characters, except for the ones shown below. 
(ASCIIia'skee) stands for American Standard Code for infomiation Interchange.) 



[ ] 



• — 
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File Extensions 



CP/AM file name exiensions also follow ihe CP/M standard. An extension can 
have from one lo three printable ASCII characters and cannot contain any of the 
"disallowed" characlere. The extension is separated from the end of the file name 
by a period. For example: 



filename.ext 

Since CP/M programs use Ihc file extension to identify the file type, you should use 
the following extensions for their intended purpose only. 





.ASM 


Assembly language source nic- 




.MAC 


Assembly language macro file. 




.HEX 


Hex formal source code Hie, 




,REL 


Relocatable machine language file. 




XOM 


Transient command program file. 




,PRN 


Print flic. (Assembly language listing.) 




XIB 


Library file. 




-SUB 


Command list for SUBMIT execution, 




-C 


C language source codc. 




.BAS 


BASIC source code filc. 




-PAS 


Pascal source code Hlc. 




-COB 


COBOL source code flic. 




.FTN 


FOR 1 HAN source code file. 




TXT 


Texi file- 




.DOC 


Documentaiion file. 




_^^^ 


Temporaiy file. 


Filename 


A Wildcard character is a symtx)l which represents a 


"Wildcards" 


characters in either a filename or extension. CP/M uses 



question mark ( ? ) and ihe asEerisk ( • ), The asterisk is used to represent either 
the entire filename , extension, or a trailing character string of a filename or 
extension. The question mark represents only a single character in either string. 
The following examples illustrate the uses of wildcanls. 

DIR A:M1SC.* 

This command displays a directory lisfing of all files on Drive A that tiave a 
filename of MISC. regardless of the extension. 

DIR '.COM 

This will return a listing of all Drive A files which have an extension of ".COM'\ 
The drive in this example is the default drive. 

DIR B:S*.COM 



This example will return a listing of all Drive B files with filenames beginning "S" 
and an extension of ".COM". 
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DIR A:????,DOC 

Since the qucsiion mark represents only one character in the string. Ihis command 
win relum ahsting of files having an extension of ", DOC" and filenames containing 
any four Cor fewer) characiers. 



Disk Drive 

Specifier 



When a command is used without a drive specifier, the default drive will be 
assumed for the operation. The default drive is indicated at the CP/AM system 
prompt by the letter immediately to the left of the caret (>). When the CP/AM 
system is first booted, the "A>" prompt is displayed- This informs the user that 
drive A is the default drive and the operating system is ready for a command. 

To change the default drive, type the desired drive drive letter followed by a colon 
and a carriage return. For example, to change the default drive from A to B, you 
would use the following command: 

A>B;<cr> 
B> 

The B> prompt indicates drive B: is now assigned as the current drive. 

Note: CP/AM stores information about the current disk in 
memory. CP/M is not like some other operating systems; you 
cannot change disks without infomiing the operating system. To 
let CP/AM know thai you have replaced the original, type a 
control-C at the CP/AM prompt. This is called "logging in" a new 
disk. 



Logical Devices 



The CP/AM operating system supports the following standard CP/M input and 
output devices: 



CON: Console device Keyboard and video display (input/output) 

LST: List device (printer) Slot 1 interface (output) 

RDR: Reader device Slot 2 interface (input) 

PUN: Punch device Slot 2 interface (output) 



Resident System 
Commands 



There are two types of CP/AM commands, resident commands and transient 
commands. The resident commands, consisring of system commands and line 
editing commands, are built into the operating system. The transient commands are 
actually utility programs stored on disk. Transient commands are covered in the 
next chapter. 



There are seven system commimds: DIR. ERA. REN. TYPE. PAGE, USER, and 
SAVE. These commands are summarized in the following pages and include 
examples of valid command expressions. 
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DTR 



ERA 



Display Directory 

DIR<cr> Displays a directory of the files on the dcFauU drive. 

DIR B:<cr> Displaysof the contents of drive B. Drive A remains Ihc default 
drive. 

B:DIR<cn> Reassigns the default drive to drive B and displays its directory. 

Erase a File 

ERA B:ABCD.BAS<cr> 

Erases tlic flic on drive B wiih a filename of ABCD and an exienaion of .BAS, 
Under CP/AM, the drive specifier is mandatory, 

ERA A;*-BAS<cr> 

Erases all ihc files on drive A with ihe extension. ,BAS. 

ERA A:*.* A:*.*<cr> 

Using the asterisk wildcard in this manner erases all files on drive A. To prevent 
accidental disk erasure, the drive specifier and wildcards must be emcrcd twice, 
as shown. 



REN 



Rename a Hie 



REN NEWNAME.BAS=OLDNAME.BAS<cr> 

Changes ihe file named OLDNAME.BAS to NEWNAME.BAS 



TYPE 



tHsplay an ASCII file on tlic screen 

TYPE ABCD.TXT<cr> 

Displays Ihe ASCII lexi file named ABCD.TXT on die monitor. The listing of die 
display can be paused at any ume by cniering a Control-S {^S). and resumed by 
pressing any key or another '^S. Pressing ^C (or any key otlier dian '^S) while die 
fiie is scrolling will abort die listing. Sec PAGE command. 



PAGE 



Set number of lines for TYPE command 

PAGE 60<cn> 

Causes the TYPE command to pause scrolling after displaying 60 lines. The 

normal (default) setting is PAGE (continuous scn:>IMng). Any value between 

and 255 is permitted. A setting of PAGE 23 is recommended for display to the 

monitor 
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USER Specify the current user 



USER 7<cr> 

Reassigns ihe user designaiion from the tlcfauH of User (or previous user) lo 
User?- A disk has fifieen possible user areas. through 15, which arc logically 
separate from one another The current user is indicated in the command prompt 
by the number to the left of the current drive indicator. No number shown 
indicates User 0, User 7. as in this example^ would display this prompt: 



7A> 

User 0, the default when the operating system is booted, is "public" to all other 
users. For instance. User 5 has automatic access to the files in Ihe UserO area. If 
the file specified is not found in the current user area, a search for the file will be 
made in User area. User does not have direct access to files in other user 
areas. 



SAVE Save mcmoiy to disk 



The SAVE command causes die contents of the Traasicnt Program Area (TPA) of 
memory lo be saved to a file on disk. This command is useful to assembly 
language programmers, but not to most commercial CP/M software users. The 
fonnai for iliis command is: 

SAVE n filename,typ 

where "n" is the number of 256 byte pages of memory, starting at address 
lOOHex. to be saved to disk. The following example will save 2048 byies of the 
system memory to Ihe file MEMSAVE.XXX- 

A>SAVE 8 MEMSAVE.XXX 



—continued next page— 
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Line EdUing 
Commands 



These commands provide some control over the screen display and allow you lo 
correci lyping crrore. Some commands can be entered by pressing a single key on 
the keyboard; oihere require the control key and another lo be pressed at the same 
time. The line editing commands are summarised below. 



<cr> 
^1 

Deleie 
Jefl arrow 



Temiinate the command line. 

Cancel and erase the command line. 

Cancel the command line. (Does not erase the command line,) 

Cancel and erase last characicror the command line, 
(backspace function) 

Continue typing the commarrf line on Ihe ncut line of Ihe screen. 

Repeat the cunent command line- 

Paiise (and resume) the display scrolling. 

Send output (or cancel output) to printer. (LST: device) 

Intermpt the current iransieni program, pcrfomi "wami start." and log in a new 
disk. E)o not confuse warm start with warm boot (Conirol-ds-Rcsec.) 



What's Next. 



This chapter has introduced you lo the CP/AM operating system and its built-in 
commands. The next chapter will explain the additional Transient Commands 
provided on the CP/AM 5.1 System Master disk. 
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CP/AM Transient Commands 



About Transient The rouiines for ihe resident commands discussed in ihe previous chapter arc 

Commands always in memory. CP/AM transient commands are not t>uilt-inio Ihe operating 

system: they are conveniently stored on disk until they arc needed. This allows 
greai versatility, since Ihey can be deleted if not needed or copied to or from 
another disk as required. 

Transient command files are identified with a type extension of XOM'. Transient 
commands arc also referred to as "transient programs/' or, simply as "programs." 
Whenany command is issued to the operating system. CP/AM evaiuaies it. tfit is 
not a valid system command, the opcraiing system automatically checks the current 
directory for a transient (.COM) fde with a filename matching the the command 
specified. 

If a transient command is specified on drive B: and the command file is not found, 
ihe operating system will automalically search for the file on the A; drive- If found, 
the command will be executed and return to the current drive upon completion. 
Only drive A: is "pubfic" lo the B: drive. Afi oUicr drives are independent devices. 

It is nol necessary to enter [he illciypc extension when executing a Iransient 
command. For instance: 

A>MEGDRIVE<ct> 

Nol all of the transient commands on the CP/AM 5.1 System Masler disk are 
explained in this chapter. Some commands have specific applications and are 
explained later in this manual. The transient commaruls covered in this chapter arc: 



FORMAT 


MEGDR [VE 


FMTUN i 


AUTORUN 


COPY 


AUTOPC 


RESTOR 


SUBMIT 


PIP 


RAMBOOT 


STAT 




Public Do main 


U til ities: 


NSWEEP 


TED 


SD 
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FORMAT Erase and format a blank CP/AM disk. 

Before informatinn can be stored on a disk, ihe disk musi be formaiicd. or prepared 
to receive ihai inrormaiion. This utility allows you to erase all previous data on the 
disk and forniat it using Uie CP/AM format. There are no command expressions for 
Ihis command. You need only lype die command, FORMAT, and specify the Uic 
proper disk drive when prompted, A typical FORMAT session, using a two drive 
system, is shown below. 

A>FORMAT<cr> 



CP/AM FORMAT VER, 1.1 

(C) 1985 & V}M BY APPLIED ENGINEERING 



FORMAT DISK IN WHICH DISK DRIVE -> B 

INSERT DISK TO BE FORMATTED AND HIT ANY KEY- 

<space b&T> 

FORMATTING... 



DO YOU WISH TO REPEAT THIS OPERATION? N 

If you had selected the drive A as your fonnatting drive, you should have removed 
the disk conlaining ihe CP/AM system and replaced il with the disk lo be fomiaited. 
When FORMAT tenninalcs, il returns lo ihe CP/AM opcraling system. Before you 
lype 'N' ai the final prompt, reinsert the disk containing the CP/AM operating 
system into the cum:nt drive. 

A non-sysicm disk fonnultcd under CP/AM can store ISSKofdata. A system diskn 
one that has the CP/AM 5. 1 operating system on disk tracks 0, 1 , and 2. has a data 
storage capacity of 126K. FORMAT does not install the operating system on the 
fonnatted disk. 



FMTUNI 



Erase and forniat a UniDisk 3.5 



This is die ulihty used specifically to format 3.5 inch UniDisks in CP/M format. If 
the boot drive ( A: ) is a 5 1/4 inch fioppy disk, the operating system in memory 
must first be configured with the PC.COM utility lo recognize the UniDisk 
interface. Refer to the section entitled Creating a UniDisk 3.5 System Disk (Chapter 
3) for more details. 

To fonnal a tJniDisk, simply enter the FMTUNI command, as shown in the 
example at the lop of the next page. In \h\s example, the A: drive is a standard 
fioppy disk; drive C: is the UniDisk, The program aulomaticafiy finds the first 
UniDisk drive in the system. 
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A>FMTUNI<cr> 

CP/AM Formatler for DISK 3.5 - Vl.O 

Insert disk to be Tormatted in drive C: 
enter 'Y' to continue, any other to quit:Y 

A fomiaUcd UniDisk 3.5 can store 776K of daia- 



COPY Copy an eniirc 5 1/4 inch disk. 



COPY will duplicate an entire disk, including Ihc CP/AM operaiiiig system tracks. 
COPY will duplicate only standard 5 1/4 inch floppy disks; il will not copy a 3.5 
inch disk. COPY can be used lo copy only the CP/AM 5.1 operating system to a 
disk already conlaining CP/M programs. 



A>COPY<cr> 



CP/AM COPY VER, 1. 1 

(C) 1985 & 1986 APPLIED ENGINEERING 



*B:=A:<cr> 

INSERT SOURCE DISK IN At 

INSERT DESTINATION DISK IN B: x 

PRESS RETURN TO CONTINUE 

<cr> 

COPYING... 

DO YOU WISH TO REPEAT THIS OPERATION? N<cr> 

• AC 

A> 

In ihis example COPY session, notice Ihe COPY command, entered without an 
argument, returns the asterisk prompt. At this point, the Destination drive = Source 
drive argumeni is entered, which is followed by the "insert source/deslinaiion disk" 
dialog. You could then replace the disk in the source drive with die one to be copied 
and place a blank disk in the destination drive, COPY fomiats the destination disk 
before copying the source disk. To exit the COPY utility and return to the CP/AM 
prompt, type Control-C {^O at the asterisk prompt. 
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The next example session illustrates ihe use of an argumenl following the COPY 
command. If ihc source and declination drives had not been the same. COPY 
would have displayed ihe dialog screen shown in ihe firsi example. Entering 'N' at 
the "-..REPEATTHIS OPERATION? " prompt would end COPY and rcium to the 
CP/AM system in drive A. 

A>COPY A:=A:<cr> 

CP/AM COPY VER. 1,1 

(C) 1985 & 1986 APPLIED ENGINEERING 

INSERT SOURCE DISK IN A: AND PRESS RETURN<cr> 

INSERT DESTINATION DISK IN A: AND PRESS RETURN<cr> 
INSERT SOURCE DISK IN A: AND PRESS RETURN<cr> 

INSERT DESTINATION DISK IN A: AND PRESS RETURN<cr> 
INSERT SOURCE DISK IN A; AND PRESS RETURN<cr> 

INSERT DESTINATION DISK IN A: AND PRESS RETURN<cr> 
INSERT SOURCE DISK IN A: AND PRESS RETURN<cr> 

INSERT DESTINATION DISK IN A: AND PRESS RETURN<cr> 
INSERT SOURCE DISK IN A: AND PRESS RETURN<CT> 

INSERT DESTINATION DISK IN A: AND PRESS RETURN<cr> 

DO YOU WISH TO REPEAT THIS OPERATION? N<cr> 



The following example shows how to copy only the CP/AM 5.1 operating system 
Irom a source disk to a destination disk. 



A>COPY B:=A:/S<cr> 

This will copy only die operating system from drive A lo tracks 0. 1, and 2 of drive 
B. Install the CP/AM 5.1 operating system only on a backup copy of your original 
CP/M program disk. 

RESTOR Restore a previously ERAsed file. 

If a file or files have been accidentally erased and nothing has been subsequently 
written lo the disk, ihis utUity can be used to recover die ftleCs). The format for this 
command is: 

A>RESTOR d;oopsnaine.ljp<cr> 

The drive specifier (d:) is required only if the erased Hie does not reside on the 
currem drive. The filename represented by "oopsname.iyp" is die name of the 
cased file. After the file is restored, it should be checked for possible damage and 
repaired. 
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PIP File copy utility 



PIP (an acronym for Perif^eral Imerchangc Program) will allow you lo copy CP/M 
files from one device lo another, PIP can be used lo manipulate and iransfcr files 
from an inpui device, usually a disk drive, lo an ouipui device — another disk* a 
primer, or the video display. 

PIP is executed by typing 'PIP' ai the command prompt as shown below. 

A>PIP<cr> 

• 

The asterisk prompt, which is then displayed below the command line> is the PIP 
console mode prompt and indicates llie program is ready to accept a PIP command 
argument. The fomiai for the command argument is: 

x:newname.typ=y;oldname,typ 

This expression will copy the existing file oldname.typ on drive y, to a newly 
created file, named newname.lyp. on drive x. The filename represented by 
'newname' is not required to have ihe same name as its original. 

•B:WHATSUP,DOC^A:SAMPLE.DOC<cr> 

• 

Here, PIP would copy 'SAMPLE.DOC from drive A lo the new file named 
'WIIATSUP.DOC on drive B, After PIP has completed the copy, it displays the 
asterisk, prompting the next command expression. If only a carriage remm is 
pressed at the asterisk prompt, PIP will stop, returning to the CP/AM command 
prompt. 

A>PTP B:=A:STAT,COM<cr> 
A> 

In this example, the PIP command and a PIP command argument are entered in the 
same system command line. Notice there is no 'newname. typ' specified. The 
'oldname.iyp'of 'STAT.COM'isused as the default name for the new file on drive 
B. When executed from ihe system prompt. PIP remms lo the system prompt upon 
completion. 

A>PIP B:-A:*.*<er> 

Using the asterisk wildcard, all files will be copied from drive A to drive B. This 
will copy only files; not the CP/AM system. 



Concatenating text files 

PIP can also be used to concatenate (merge) two or more ASCII texl files. (ASCII; 
American Standard Code for Infonnation Interchange) The next example 
demonstrates a sample concatenation expression. The multiple source text 
fdenames must be separated by commas. 



13 



Transient Commands 



Chapter 2 



A>P1P B;BIGFILETXT=A:FILEA.DOC,FILEB.DOC.TEMP.TXT<CF> 

First. Ihc contents of the FILEA.DOC will be copied to the new file. 
BIGFILETXT, on tJlc B: drive. Ncxl, Ihc contems of text file. HLEB.DOC will 
be appended lo BIGFU^.TXT. followed by TEMP.TXT. 



Comparing files 

One of PIP's many useful features is iLs ability to compare Ibe comcnis of Iwo files. 
This feature is implemented by separating ihe destination from ihc source with a 
double colon. ( x:desi.iyp::y:source.typ ), The drive specifiers (A and C in the 
example below) an; not required if the files are located on the same disk. 

A>PIP A:NSWEEP.DOC::C:NSWP-TXT<cr> 

The contents of both files will be read and compared, byte for byte, PIP responds 
with either Tiles are ideniical^' or Tiles MISMATCH." 



Sending Output lo Console or Printer 

PIP will also send text file output from a disk device to a non-disk device. LST: is 
the logical device name for the slot 1 ouiput device — usually a primer interface. 
PUN: is the slot 2 output device and CON: is die video display's device name. 

A>P1P CON:=NSWEEP.DOC<cr> 

This will send the contents of the text file. NSWEEP.DOC to tlie video screen. 
(Try it: NSWEEP.DOC is on i]ie System Master) 

In Ihe next example, ihe contents of the same texl file is sent to the printer. 

A>PIP LST:=NSWEEP,DOC<cr> 

To pause output to the LST: or CON: devices, enter a control-S from the keyboard; 
press any key to continue. To abort, enter a control-C. 



Inpul from Console 

By specifying a disk device and filename as ihe destination, and tlie console (CON:) 
as Ihe source device, you can create a text fde directly from the keyboard. 

Input from the CON: device puis PIP in the line insertion mode, indicated by die 
hyphen prompt, Texl is entered a line at a time, each line followed by a caniagc 
reium. The last line musi contain only die file's End-Of-File (EOFJ maik» a control- 
Z, followed by a carriage return. 
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A>PIP B:SAMPLE.TXT=CON:<cr> 
-The quick brown fnx<cr> 
-jumps over<cr> 
-Ihe lazy dogs,<cr> 

A> 

In this example, PIP has created Ihe text file. SAMPLE.TXT. containing Ihe Icxt 
entered from Ihe keyboard. This feature is very useful for creating a SUBMIT 
execution file. 

If LST: is named as the destination device, output will be sent from the keyboard to 
the printer, as illustrated below. 

A>PIP LST:=CON:<cr> 

-How now<cr> 

-brown<er> 

-cow?<cr> 

-'^Z<cr> 

A> 



Special PIP Devices 

Additional source devices are provided by the PIP command program. These are 
specialized devices with specific apphcaijons. 

PRN: This is the same as the LST: device, only different. In the destination file, 
tab spaces are set to every eighih character position, form feeds are inserted every 
60hnes, and each line of text is numbered. This is equivalent to the LST: device 
used with PIP parameter [NP6QTS]. PIP parameters are explained in the next 
section. 

NUL: This ouEput device sends out 40 ASCII null characters. It's mat handy if 
you want to concatenate a 4 inch blank leader and u^aileron your papcriapc. 

EOF: Output device which sends an EOF {^Z) mark to the destination device. 
This is rarely used in disk to disk U"ansfers; PIP auiomatically inserts the EOF marie 
at Uie end of each file. 



PIP Parameters 

During the PIP file transfer from one device to another, special parameters can be 
used to affect the file being transferred. These parameters can t>c invoked by 
appending the PIP command line with parameter code lettera enclosed by square 
brackets. For example: 

A>PIP B:*.TXT=A:*.TXTlCEV)<cr> 
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The following is a description of each of Ihc valid parameters. These are not 
"toggle" parameters. They are only valid during the execution of the current 
command expression. 



A Attribute archive mode 

This parameter sets the PIP archive mode. Only the specified source files with their 
archive atuibutcs reset lo xero will be copied to die destination. Once die source file 
has been copied, ihc archive attribute in the source file directory is set to indicate 
thai the file has been archived. 

Note: STAT.COM or NSWEEP.COM can be used to set or reset 
dw archive attribute. 

One very useful application of die archive mode is "backing-up" (archiving) a larger 
disk onto several floppy disks. If one of the floppy disks becomes full, the file 
being transfcrrcd at die lime is closed and renamed lo indicate that it is only a panial 
file. The current floppy disk is logged out and PIP displays a prompt for another 
formatted fioppy disk. The remainder of die partial file is copied and Uiis process 
continues until ^ specified files are archivcd. 

For example, if the file. AEDATA.TXT. is being copied. PIP will close the 
destination file when the destination disk becomes full and name it 
AEDAT#01-TXT, The next segment of this file will be closed as 
AEDAT#02.TXT. If diis same file was large enough to span another fioppy 
volume, it would be closed as AEDAT#03,TXT on the next disk. Reloading 
segmented are^iive files is accomplished with die [Rn] parameter. 

B Archive aU mode 

This parameter does not set die PIP archive mode, but must be used in combination 
widi die lA] parameter (i.e. |AB]). All specified files are copied regardless of die 
state of their attribute fiag. Functionally, diis parameter is the same as the [A] 
pammeter. 

C Console confimiadon prompt 

PIP wU] pause after each fde copied and display a prompt similar to this: 

COPYING: 

A1SD.DQC Copy Ihis Hie? (V/N): 

Enter Y for Yes. N for no. Lower case is accepted. You will be prompted in diis 
manner for each file to be copied. 

Dx-y Delete columns 

Only ASCII text files are affected by die [DK-yl parameter. From each line of text 
transferred. PIP will extract and copy only die characters between and including the 
column positions indicated by die numeric variables, x and y. The variables must 
t)e separated by a hyphen. The x variable is the beginrung column position; y is the 
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ending position. If onJy one value is entered. aJl characters past the value indicated 
are deleted during inmsfer to the dcstmaiioiL 

E Echo to console 

You should use the [E] parameter only when transferring ASCII text files. The 
contents of text files will scroll past on the console display as they arc being copied, 

F Filler form feeds 

All form feeds, sometimes called page ejecLs, will be removed as it is being copied 
to the dcsUnation. When used with the [Px-yl parameter to inscn page ejects, form 
feeds aiE filtered from the text before the page ejects are inserted. 

Is Ignore all past mask character strings 

PIP will omit, from the text Hie being transferred, all character beginning with and 
including the mask character string to the end of the current line. Theendof line is 
marked by a carriage return followed by a line feed. (cr,lf) The carriage return and 
hne feed are also removed. 

The mask character string, represemed by s. is any alphanumeric character string 
ending in acontrol-Z, IMPORTANT: This comparison string MUST end with a 
con[rol-Z! Before executing die transfer. PIP will display the message: 

Ignore "(s string)" through cr,ir. OK? (V/N): 

J Prompt for source and destination disks 

This parameter is most useftd forcomputer systems with only one disk drive. You 
will be allcmately prompted to insert the source and destination disks until the 
specified files have been copied. As an example: 

A>P1P A:=A:CPAM60F.COM[J]<cr> 

Install SOURCE disk, then press cr (or Q to quU):<cr> 

Install destination disk, then press cr (or Q to quit):<cr> 

Upon completion PIP will attempt lo return to the warm boot back to the current 
disk. Make sure die destination disk has a bootable operating system also, 

L Translate upper case to lower case 

All upper case characters encountered in the source text file will be converted to 
lower case characters in the destination fde. 
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N Add line numbers 

Sequential line numbere, each followed by a colon and a space, will be added to Uic 
beginning of each line of a desiinalJon text file. Line numbers start at 1. 

O Disable line editing during object code file transfer 

This parameter is used for the transfer of non- ASCII files only, Tt wiU cause PIP to 
ignore any control-Z encountered in Ihe transfer of a non- ASCII (object code) file. 



Nonnally, when FTP encounters a comrol-Z during an ASCII text file transfer, it 
inieiprets it as an end-of-file mark and tenninaies the transfer. Unfortunately, a 
conirol-Z imbedded in a non-ASCII file will also end Ihe transfer — ^unless the file 
type is .COM. Although .COM Tiles arc non- ASCII files. PIP assumes that a file 
with this extension is not an ASCII file and automatically ignores any control-Z 
characters. 



P X - y Print x lines, starting at page y 

When sending ASCII text file output to the LST: device (printer), PTP normally 
does not insert fonn feed commands. The numeric variable, x, determines the 
interval number of Unes printed before a form feed character is sent to the l-ST: 
device Oiries per page). The y variable is optional and tells PIP to start priming y 
number of pages from the beginning of the file. The variables must be separated by 
a hyphen. 

PIP docs not insen fonn feed characters when copying text files to anoiher disk 
device or the CON: device. 



Qs Quit copy at mask character string s 

ThL^ parameier can only be invoked from ihe PIP console mode. 

PIP win temiinate the text file copy when ihe character string s is first encour\iered. 
The characters matching ihe mask string will not be copied. 

The mask character string, represented by s, is any alphanumeric character string 
ending in a control-Z, IMPORTANT: This siring MUST end with a comrol-Z! 

Rn Reload segmented archival files 

This parameter is used when reloading files which were archived under the [A] or 
[AB] PIP parameters- The variable, n, indicates the number of archived file 
segments to be restored. For example, to reload the files archived in the example 
given for ihe [A] parameien 

A>A:AEDATA.TXT=B:AEDAT*.TXT[R2]<cr> 
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Notice the asterisk wildcard character is used lo select any file beginning with 
AEDAT# and ending with an e\iension of .TXT. In this case, the two archive file 
segments created by PIP were AEDAT#OI .TXT and ADAT#02,TXT. The n value 
of2in this example tells PIP that two file segments are to tte concatenated jo form 
Ihe file AEDATA.TXT. 



S s Start copying at mask character string s 

This parameter can only be invoked from the PIP console mode. 

PIP will twgin copying a specified text file when the character siring s is first 
encountered. The characters matching the mask siring will also be copied. 

The mask character string, represented by s, is any alphanumeric character string 
endinginacontrol-Z. IMPORTANT: This string MUST end with a comrol-Z! 

Tn Set tab spaces 

Tab spaces will be set at each column position interval specified by the variable n, 

U Translate lower case to upper case 

All lower case characters encountered in the source lexi file will be converted to 
upper case characters in the destination fde, 

V Verify file copy 

This parameter will cause PIP to verify each destination file against its 
corresponding source file after it has been copied. 

2 Zap (clear) parity bit 

PIP will clear the parity (high order) bit of each character copied to the destination 
text file. 

STAT Slams 

STAT provides the user with infonnation about one or more files or disks. The 
information returned by STAT depends on the various arguments which can be 
used with the STAT command. 

STAT comes with its own built in help screen. As a reminder, whenever STAT Is 
invoked, the fim fine displayed is "Type STAT ? for Help." 
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STAT Help Screen: 

Display logged disks & space available: 

STAT 
Display space available on d: 

STAT d: 
Display file size and attributes: 

STAT drafn 
Display users on d: & their disk space: 

STAT d:*.* U: 
Set file attributes; 

STAT d:ufn $<;R/0,R/W,SYS,D1R> 
Allernafive set of clear file attributes: 

STAT d:urn $<S,C><F<l-8>,T<l-3» 
Clear all file attributes: 

STAT d;urn SALL 
Write protect drive: 

STAT d: $R/0 
Set the iobyte: 

STAT <LST,PXJN,RDR,CON> T:<0,1,2,3> 
Display the iobyle: 

STAT X T: 
Display disk size & characteristics: 

STAT X S: 



Disk and file status 

Several different STAT command line arguments can be used lo provide a variety of 
infonnaiion about the disks and files logged in the system. 

A>STAT<cr> 

Type STAT 7 for Help 

A: R/W, Space: 12K 

In this example, only the STAT command was issued, returning the disk access 
status (RAV) and the amount of useable space left on drive A, If drive B. or any 
other drive, had been accessed since the last warni start or cold boot, STAT would 
also rerum the status of that drive. R/W indicates that the drive Is tx>ih read and 
write enabled. 

A>STAT B:<cr> 
Type STAT ? for Help 
B: R/W, Space: !12K 
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The drive specifier argument following the STAT command will cause STAT lo 
return only Ihe status of the drive specified. 



A>STAT B:STAT.COM<cr> 
Type STAT ? for Help 

Recs Bvtcs Pex Ace 
35 Sk 1 R/W 

B: R/W Space: U2K 



B: STAT XOM 



By specifying a specific (unambiguous) filename, STAT will provide infomiation 
about itiai file. The drive specification is optional. In this case. STAT has returned 
infonnaiion about Ihe STAT.COM file on drive B. The Recs (records) column 
showsihenumbcrofl28k byte records in the file and the Bytes column indicates 
the number ofbytes in the file. Tf Bytes divided by Recs doesn't equal eight, don't 
be alarmed — close counts. The number of ICK extents (file pieces) in the 
specified file is indicated in the Pex column. The Ace column shows the file access 
attribute status of the file — eiOier RAV or R/O, 

A>STAT B;',*<cr> 
Type STAT ? for Help 



Recs Bytes Pex 


Ace 








30 4k I 


RAV 


B: 


COPY 


■ COM 


30 4k 1 


RAV 


B: 


FORMAT 


.COM 


18 3k 1 


RAV 


B: 


MEGDRIVE 


.COM 


35 Sk 1 


R/W 


B: 


MVFILE 


.DOC 


96 12k 1 


B/W 


B: 


cp/am ,sys 




B; R/W Space: 122K 









This example illustrates a variation of the preceding example, using the asterisk 
(ambiguous filename) wildcard lo select all files on drive B. The last file shown in 
Ihe list is die file containing die CP/AM operating system. 

The following STAT command exprxission will provide general infonnation about 
a specific disk drive. 

A>STAT B: S:<cr> 
Type STAT ? for Help 

B: Drive characteristics 

1120; 128-byte record capacity 

140: kilobyte drive capacity 

48: 32-byte directory entries 

12: checked directory sectors 

128: records/ physical extent 

8: records/ reservation block 

32: 128-byle sector/track 

3: reserved tracks 
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To display information about all users on a specific drive: 

A>STAT B:*-* U:<cr> 
Type STAT ? for Help 
User Files Phy Exts Space 

OSS 19k 

7 4 5 48k 

Each user is listed, followed by Ihe number of files, physical extents, and space 
used ( — not space available). 



Allributes 

There are eight user (advanced user, thai is) definable file attributes and three 
standard, predefined file aitribuies. The STAT command associates each of the 
eleven anribuies with a specific character position in the file's name and cxtension. 
Thc user anribuies are assigned to the eight filename character positions. The 
examples in this section deal with the predcrmcd attributes associated with the three 
characters of the filetype extension. 



Comments 

Read/Write or Read/Only 

SYS files do not show in norma] directory. 

Identifies files which arc to be archived. 

To write protect a file, you must set the file access flag. STAT provides two ways 
10 do this. The most convenient way is with (his command expression: 

A>STAT BiMYFILE.DOC $R/0<cr> 
Type STAT ? for Help 
File set to R/0, 



Another way would be to set the Hag (Tl) with this expression: 

A>STAT B:VOURFILE.DOC SSTl<cr> (Sets filetype 
extension position 1.) 

Both of the preceding examples have the same effect on both files; the files can 
only be read. To wiiie enable die file MYF1LE.DOC. the file access attribute must 
be cleared with one of Uic following expressions: 

A>STAT B:MYF1LE.D0C $CTl<cr> (Clears filetype 
extension position 1.) 

or I 

A>STAT B:MYFILE.DOC $R/W<er> 
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Using STAT lo return the aiiribute status of these files will yield this result: 

A>STAT B:*.DOC<cr> 

Type STAT ? for Help 

Recs Bytes Pex Ace 
91 12k 1 R/W B: MYFILE .DOC 

183 24k I R/0 B: YOURFILE .dOC 

B: R/W Space: 75K 

Notice thai YOURHLE.DOC is still write proiccicd. as indicated by R/0 and the 
lower case first character of the filctypc extension. 

The procedure is the same for setting the system indicator attribute flag. Either of 
the following two command lines will set the SYS attribute. 

A>STAT MEGDRIVE.COM $ST2<cr> (Sets flletype 
extension position 2.) 

or 

A>STAT MEGDRIVE.COM $SYS<cr> 

No drive specifier was entered: the default drive is assumed. Using STAT to 
return the attribute status of this file will yield this resuU: 

A>STAT MEGDRlVE.COM<cr> 
Type STAT ? for Help 
Recs Byles Pex Ace 
IS 4k 1 R/W A: MEGDRIVE XoM 

A: R/W Space: 22K 

The second letter of the fileiype extension is displayed in lower case, indicating the 
system (SYS) attribute is set. Remember, with its system attribute set, 
MEGDRIVE.COM will not show up in a directory displayed with the DIR 
command. 

Setting the archive attribute is accomplished with this STAT command line: 

A>STAT WIDGET.DOC $ST3<cr> 

Wlienever STAT is used to check the file status of WIDGET.DOC, STAT will 
indicateihai the archive attribute is set by displaying a lower case character in the 
third character position of the filctypc extension. 

This command line wiU clear ihe archive atuibuie: 

A>STAT WIDGET.DOC $CT3<cr> 
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All of a file's aUributes can be cleared with the following STAT command 
expression: 



A>STAT SUBMIT.COM $ALL<cr> 

Type STAT ? for Help 

Recs Bytes Pex Ace 

18 4k I R/W A: SUBMIT .CoM 

all attributes cleared 
A: R/W Space: 3S0K 



MEGDRIVE InsiaU CP/AM MegDrive™ 



With the MEGDRIVE uiilily program, the memory available on a Z-Ram or 
RamWorliS^ card can be used lo emulate a CP/AM volume (called, MegDrive). A 
standard (64K) extended BO column card can also be used, but it will only t>e able 
to provide 64K of data storage space. The example, below, illustrates a MegDrive 
emulation on an Apple //e wiih a 3 Meg Ram Works caid installed. 

A>MEGDRIVE<cr> 

Applied Engineering MegDrive v— ©1987 

MEGDRIVE is installed as disk C: 
Available storage is 3040K 



In Ibis example, MegDrive was installed by entering ihe MEGDRIVE 
command. "MEGDRIVE is emulating C:" indicates die MegDrive, designated as 
drive C is now installed inio 3Mcg of available memory. Checking the STATus of 
drive C the emulated disk storage available on drive C is 3040K. 

MEGDRl VE assigns drive C as the default MegDrive. If you have a single drive 
system and wish to assign the MegDrive as drive B, use the command line sbown 
in the next example to initially install a MegDrive. If a MegDrive is already 
instidled. ihc current MegDrive specifier will be changed lo the new drive. 

A>MEGDRrVE B:<cr> 

IMPORTANT: Be careful not to assign a MegDrive device 
specifier thai is already in use. For instance, activating a 
MegDrive as B: would override the slot G, drive 2 disk drive. 

To copy files to the CP/AM MegDrive, use the PIP utiUiy, COPY will not copy lo 
or from the MegDrive. nor will it copy the CP/AM 5.1 operaring system to the 
MegDrive. Unlike die RAMcanl CP/AM volume (described in the nexi chapter), 
the MegDrive cannot be booted. 

The MegDrive remains enabled until the computer's power is turned off or the 
system is cold booted. The CP/AM Control-C warm start does not affect the 
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MegDrive. When the system is cold booted (Control -0- RE SET), the MegDrivc 
niusl be re-enabled by issuing the MEGDRIVE command. Entering tlie 
MEGDRIVE command while a MegDrivc is already installed has no effect on the 
flics stored in the MegDrivc, Holding the Open-Apple (0) key down during 
MEGDRIVE execution wiU en:tblc ilic audible disk access indicator. 

Jusi as the red "disk use" indicator light indicates a disk access in progress, MegDrivc 
provides a visual access indicator. Whenever the emulated drive is accessed, an 
inverse "R" or "W" wiil appear in ihc lower right comer of the display. The "R" 
indicates a read operation; the "W" signifies a write operation. 

MEGDRIVE also optionally supports the Double High Resolurion Graphics feature 
of the Apple llGS. y/c and //e by locking out bank of auxiliary memory. If your 
CP/M program requires the use of double high resolution graphics, or any oUicr 
poTlionofbankOofauxiliary memory, enter the MEGDRIVE command as shown 
below. 

A>MEGDRIVE<cr> 

Applied Engineering MegDrive v— ©1987 



AUTORUN 



AUTOPC 



MEGDRIVE is installed as disk C: 

Available storage is 3024K 

Memory is configured for Double-HiRes graphics 

NOTE: Pasi RAMDRIVE u.sers should be awarc that MEGDRIVE 
wiU not create a hie called "DDLHIRES". 

Scisianup floppy disk only 

AUTORUN allows you to customize a CP/AM boot disk. Whenever an 
AUTORUN modified system disk is cold booted, the first command line is 
automatically entered and executed. Any executable command file can be specified. 
The example below shows how AUTORUN can be used lo install a MegDrivc 
whenever the system disk is cold booied. 

A>AUTORUN MEGDRIVE<ci> 

CP/AM AUTORUN VER.1.1 

A> 

To cancel the startup command file, simply execute AUTORUN without a 
command argument. 

Set startup — UniDisk 3,5 or Protocol Converter devices only 

This command supports only devices which are attached to the computer via 
Apple's Protocol Converter interface (e.g. UniDisk 3.5. RamFactor. and the 
Apple n Memory Expansion Card). It is invoked in the same manner as 
AUTORUN. 
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SUBMIT Aulomaticscqucniia] command execution 



Usually, CP/M commands arc entered and executed one ai a time from ihc 
keybt^ard. By taking its commands from a special file instead of ttic keyboard. 
SUBMIT allows you to group several commands together in a "batch" for 
sequential processing without your intervention. 

The commands (o be CKecuicd must be valid CPA^ commands and contained in a 
CP/M text file wiih a filetype extension of .SUB. A SUBMIT command flic can 
be easily created and edited with a CP/M text or tine editor. The PIP utility can also 
be used to create a ".SUB" fUe, Each line of the text file must contain a valid CP/M 
expression, followed by a carriage return. In the following example, the TYPE 
command is used to display the contents of a sample submit file on the CP/AM 5.1 
System Master disk. 

A>TYPE SAMPLE.SUB<cr> 

dir 

megdrivG d: 

pip d:=A:pip.com 

stal d: 

A> 

When SUBMIT is executed using the SAMPLE.SUB file, as shown in the 
example below, the commands in the ".SUB" file an; executed au torn aii call y, one 
line at a lime. SUBMIT cteaies a temporary command fvle on die current disk from 
your ".SUB" file with Uie filename of "$@S.SUB" which it then uses to execute 
the command sequence. This temporary file is erased upon completion of the 
command sequence. 

A>SUBMIT SAMPLE<cr> 

This example uses the SUBMIT file, SAMPLE.SUB. to firjsi display a directory of 
drive A, die current drive. Then die following tine installs a McgDrivc as drive D. 
In the next line, PIP copies itself into the newly created McgDriveand tiie last line 
returns die status of die MegDrive. 

To create a SUBMIT command file using PIP, foUow die procedure oudincd here: 

A>PIP A:STARTUP.SUB=CON:<cr> 

-megdrive<cr> 

-pip e:=a:*,com<cr> 

-dir c:<cr> 

-^Z<cr> 

The command line in this example creates a file on drive A widi the filename of 
STARTUP.SUB and assigns the keyboard or CON: as the input device. The 
commands to be executed are then entered following die PIP's hyphen prompts. 
Each fine is ended with a carriage return. The last line, or "end-of-file." is 
indicated by a control-Z, followed by a carriage return. 
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SUBMIT and AUTORUN can be used in combination lo create a startup disk which 
will automatically execute a SUBMIT file when ihc disk is cold-booied. The next 
example iilusiraies the AUTORUN command line using SUBMIT and the file 
created in Ihc previous example. 



A>AUTORUN SUBMIT STARTUP<cr> 



RAMBOOT 



RAMcaid rc-boo I utility 

This utUiiy supports both Ihc Applied Engineering RamFacior card and ttie Apple n 
Memory Expansion Card. Nonnally, a conirol-reset will only reboot die CP/AM 
operating system. RAMBOOT provides a convenient exii path to or from a 
RAMcard. The effect ofUiis utility depends on the type of RAMcard Lnsudled. 



RamFacior: If the RamFactor is dedicated to CP/AM. RAMBOOT accesses the RamFactor 
Partition Manager menu. If the RamFacior is dedicated [o a non-CP/AM operating 
system and is in "Apple II Memory Expansion Card emulation mode'' (i.e. Partition 
Manager firmware is inactive), the current (bootable) RamFactor volume will be 
booted. The following message will be displayed if the RamFactor volume is not 
bootable and the Partition Manager has not been previously accessed: 

WARNING- INSTALLING PARTITIONS DESTROYS 
THE DlRECTORY^ GO AHEAD? 

Press "Y" to access the blank RamFactor Partition Manager menu- Pressing any 
other key will exit to BASIC. 



Apple TI Memory RAMBOOT will exit CP/AM and enter die Applesoft BASIC mode (no operating 
Expansion Card: system) if die current RAMcard volume is not bootable. 

No RAMcard found: The error message, "Can't find RAMCARD. exiling 
program!," will be displayed. 



Public Domain Utility Transient Command Files 

For your convenience. Applied Engineering has included some useful public 
domain utility programs on the CP/AM 5. 1 System Master disk. 



NSWEEP This IS a disk maintenance utility program that combines many of die features of 
PIP, STAT, USER. TYPE. BRA, and REN into one menu-^driven package. It is 
very quick and versatile! 
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SD 



SD siands for "Super Directory." It makes up for the features that die DIR system 
command doesn't have^ 



TED 



This is a powerful, easy lo use text editor. Il isn't Wordsiai®, but as a simple line- 
oriented editor, it's very useful. 



Detailed user doctimeniaiion for (hese public domain programs is also provided on 
side two of the disk. The insiruciions for NSWEEP art contained in a standard text 
file named NSWEERDOC on ihe backside of ihe CP/AM 5. 1 System Master disk. 
Since disk space is limited. Ihe documentation files for SD and TED have been 
condensed, or "squeezed" by the NSWEEP program. NSWEEP will conven 
squeezed files to standard text files with a filename extension of ".DOC" 
NSWEEP is also capable of printing squeezed files directly. 

Standard text tiles can be displayed on the screen by using die TYPE command and 
echoed to the printer by toggling the Conlrol-P command. The PIP command can 
also be used to output all of the documentation files to your printer by using the 
following command line. 

A>P1P LST:=A:filenanie.DOC<cr> 

In ihis command line, "file name. DOC represents the unambiguous filename of tbc 
documcniaiion file you wish to print. 



What's Next... 



With the infomiation covered in Chapters I and 2, you should now be able to 
create, view, erase, and transfer CP/AM files. Chapter 3 explains how to create 
your own bootable disks and, if necessary, how to configure the CP/AM operating 
system to match the configuration of your computer system. 
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CP/AM System Configuration 



The first iwo chapters have given you an iniroduction lo the CP/AM operating 
system and its commands. This chapter explains how lo create your own bootahle 
system disks and how lo customize the CP/AM 5.1 operating system to match the 
configuration of your computer system. 

Here are the topics covered in this chapter: 

CP/AM System Disk Description 
Creating a Floppy (5 i/4'0 System Disk 
Creating a UniDisk 3.5 System Disk 
Creating a RAMcard System Disk 
Configuring die CP/AM 5.1 Operating System 
Configuring Non-Standard //c Serial Ports 
CP/AM for 48K Compulcre 

CP/AM System A system disk contains the CP/AM operating system on specific tracks the disk, 

Disk Description called boot tracks. Whenever a system disk is booted, the operating system is 

loaded into memory from the boot iracks. The booiiracks of a standard 5 1/4 
inch fioppy disk, tracks 0, 1. and 2, are nomially reserved as boot tracks, but if no 
operating system is written to them, Uiey can be used to store data. The boot tracks 
of a CP/AM fonnatted UniDisk 3.5 are pennancntly reserved for the operating 
system only. A non-system disk can only store data; it cannot t»e booted. 

There are four transient program (.COM) files on the CP/AM System Master disk 
which, when executed, will install or replace Uic operating system on the boot 
tracks of a formatted CP/AM disk. Two of the programs^ CPAM60S and 
CPAM60F, will install the CP/AM 5.1 operating system on a standard (5 1/4) 
floppy disk only. The other two programs, CPAM60US and CPAM60UF, will 
install the operating system only on a UniDisk 3.5. The PC program, described 
later in this chapter, is used to install the operating system on a RamFacior or an 
Apple II Memory Expansion card. 

The "S" and "F" variations of the operating systems offer two different video 
device drivers. (A device driver is a software routine thai is called by the operating 
system when ii needs to interface with a specific type of input or output device — in 
this case, the video screen.) The ^'S" (standard) version uses a "fimiware screen 
output driver," as opposed to the faster direct "hardware output driver" used by die 
"F' (fast) version. The fast driver allows the video display to scroll approximately 
30 percent faster. The fast driver also has two other features useful to Wordstar 
users: "delete line" (Esc E) and "insen hne" (Esc R) arc supported by the "F" 
versions of tile operating system. 
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The standard driver is compatible wiih all SO column displays except the Franklin 
Ace 2x00 series display^ which requires the fast video driver. Computers which 
have an 80 column text card installed in expansion slot three must use one of the 
standard video driver versions of the CP/AM5.1 operating system, (i.e. Apple U, 
Applet! Plus, and Franklin Ace 1x00,) 

The fast video driver is recommended for computers which use or emulate an 
Auxiliary Slot &0 coXnmmexi card. (i.e. Apple Tics, Apple //c. Apple //e. Franklin 
Ace 2x00. and Laser 128.) 



Creating a Floppv 
(5 1/4") System " 
Disk 



The first step in creating a system disk (either floppy disk or UniDisk 3.5) is to 
install the appropriate video driver on a COPY of the CP/AM 5,1 System Master 
disk. The operating system loaded from the CP/AM 5A System Master contains 
the standard video driver. This version can be updated (replaced) by booting a 
COPY of the System Master and entering the CPAM60F command, as shown in 
the example below. 

A>CPAM60F<cr> 

CP/AM Ver 5.1 UPDATE PROGRAM 
(C) 1986 APPLIED ENGINEERING 

FOR HARDWARE SO-COL ONLY! 
INSERT DISK INTO DRIVE A: 
AND PRESS RETURN TO BEGIN 



When the fast driver operating system is then twoted. the following message will 
t>e displayed below the CP/AM copyright notice: 

HARDWARE 80-COLUMN DRIVER IN USE 



Note: At this time, you may wish to delete some of the 
unnecessary files from your COPY of the System Master disk. If 
you win t>e configuring tlie operafing system (o support the 
UniDisk 3.5 or other Protocol Converter device, you will need at 
least I5K of available disk space to save the system configuration 
file. 

Before the CP/AM operating system can be installed on a floppy disk, the disk 
must bQ formatted in CP/AM fomiat. (The FORMAT command is explained in 
Chapter 2.) Once properly formatted, either the CPAM60S or CPAM60F 
programs can be executed to write the operating system to the disk's boot tracks. 

Afier the operating system is installed, PIP or NSWEEP can be used to copy ihc 
desired transient command files (programs) from another disk. 

Note: The operating system tracks can also tte copied from one 
floppy disk to another floppy disk by using the "/S" feature of the 
COPY command. Attempting to use ihis method to copy the 
operating system from a floppy disk to a UniDisk 3,5 will result in 
an enor message. 
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Crealing a The standard CP/AM 5 J operating system on ihe CP/AM 5.1 System Master does 

UniDisk 3.5 not automatic ally recognize devices which use Apple Computer's Protocol 

System Disk Converter bus interface. The standard Disk II floppy disk interface \& not a 

Protocol Convener device, but ibe UniDisk 3.5 is. Before a UniDisk 3,5 can be 
formatted and its operating system installed, the CP/AM 5.1 operating system 
loaded into memory from the floppy disk must be configured to recognize the 
UniDisk's Protocol Converter interface. 

The Protocol Converter is a sophisticated program which provides a standardized 
method of attaching a series of mass storage devices (disks) to the Apple //c disk 
port or a UniDisk 3.5 interface. These devices are linked along a common data 
channel called the Protocol Converter bus. The firmware (Read Only Memory) on 
the Apple II Memory Expansion Cairf and the RamFactor also provides the features 
ofihe Protocol Convener for one I/O device — the memory card itself. 

Bool your COPY of the CP/AM 5.1 System Master disk. If you have not already 
done so, install the operating system with the video driver you wish to have 
installed on the UniDisk 3.5 system disL Execute the PC.COM transient program 
and add the UniDisk 3.5 into the device table as any device except the A: drive. 
Save the connguration Hie to the floppy disk. Accept the default name of 
CAUTO.COM, An error message at this point probably indicates there is not 
enough room on the disk for the CAUTO.COM conHguration file. If necessary- 
reboot, ERAse any unnecessary files, and begin the configuration procedure again. 

Whenever the configured floppy disk is booted, the operating system aulomaiically 
executes the CAUTO.COM file, which installs the specified configuration. The 
UniDisk can then be formatied (FMTUNI) and the desired operating system written 
to Ihc UniDisk^s boot tracks (CPAM60US or CPAM60UF)- 

Creating a Since the RamFactor and Apple H Memory Expansion cards are Protocol Convener 

RAMCARD devices, the PC udliiy. provided on the CP/AM 5.1 System Master disk, is used to 

System Disk install the operating system. If the operating system is to be installed on the 

RamFactor panition. you must first use the RamFactor Partition Manager 
menu lo set tlie desired panition number, size, and name. It is not necessary to set 
the panifions if RamFactor is to be totally dedicated to CP/AM (emulating the 
Apple II Memory Expansion Card). 

Note: IlGS usere should refer to Appendix A for specific 
infonnation about setting up the PC menu for the IIGS. 

Boot the CP/AM 5,1 System Master disk. If you have not already done so. use 
either the CFAM60S or CPAM60F command to install the operating system with 
the video driver you wish to install on the RAMCARD volume. Execute the 
PC.COM LTdnsiem program and add and install the RAMCARD device as the A: 
drive. As prompted by the PC program, write the CPAM60UF,COM operating 
system to the A: device. 

The RAMCARD volume can now be booted just like any other disk drive. If the 
RAMCARD is in exparL'^ion slot 7 of an enhanced Apple //e. the A: volume will be 
booted by a Control -O-Reset 

Reminder: The RAMCARD's RAMdisk is a voiaUle storage 
medium! When the computer's power is removed, even for an 
instant, infonnation stored in a RAMdisk is completely losi — 
unless you have a RamFactor equipped with a RamCharger™ 
(battery back up and auxiliary power supply). 
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WARNING: If you write a file to ihc RAMdisk using a different 
operating system, it will overide the previous operating system. For 
example, if you are currently in CP/AM and you write a file to the 
RAM disk using Pascal, you will lose your CP/AM files currently in 
your RAM disk, A list or the Hies may still be displayed but the 
actual files will be gone. 

Configuring the Special configuration is only required lo support devices wtiich use Apple 

CP/AM 5.1 Computer's Protocol Convener bus. Standard (Disk II) type floppy disk 

Operating System interfaces and most hard disk interfaces do not use the Protocol Converter. 

The PC.COM utility, provided on the CP/AM 5,1 System Master disk, is a menu- 
driven program which will allow you to configure the CP/AM 5. 1 operating system 
to: 

■ rccognixe a UniDisk 3.5 interface or other Protocol Converter device. 

■ recognize a llGS SmanPori device (3.5 drive or memory expansion card). 

■ crcaicabootableRamFactororApple II Memory Expansion Card volume. 

• assign the primary boot device, (drive A:) 

• arrange the mass storage (disk) device table. 

The PC device table can be configured lo support a combination of six disk 
devices. These devices include: 

' GS Memory Expansion slot card or SmartPorl devices in a IlGS 

■ Standard Disk 11 type interfaces 

- Protocol Converter bus interface devices (TJniDisk 3,5) 

■ Protocol Converter R.'^MCARD devices (j^amFacton Apple II 
Memory Expansion Card) 

• GS-RAM. or RAM card 

• Sider Hard Disk interface device (installed separately by Sider 
installation program, described in Appendix C) 

Note to Sider hard disk users: Install the CP/AM 5J operating 
system onto the Sider before using the PC utility lo install Protocol 
Converter devices, (refer to Appendix Q, 

When executed from an unmodified CP/AM 5.1 operating system, the PC 
command wiU display this Device Table: 

DRIVE DEVICE NAME UNIT # 



APPLE DISK n 1 

APPLE DISK II 2 

APPLE DISK n 3 

APPLE DISK n 4 

APPLE DISK n 5 

APPLE DISK n 6 



A ' Add devjce(s) R - Restart from scratch 

Q - Quit w/ no update S - Sel last valid device 
Any other = Install as above 

PC.COM Vl.O - Choose action ====> A 
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The Device Table reflects the standard (default) CP/AM configuration for disk 
interfaces, as shown in the following chan. The DEVICE NAME column indicates 
the current device type assigned to the corresponding drive spcciHcr. 



CP/AM device 


Physical Apple 


Interface 


Drive Specifier 


Slot 


Drive 


A: 


6 


1 


B; 


6 


1 


C: 


5 


1 


D 


5 


2 


E: 


4 


1 


F: 


4 


2 



Configuration begins by selecting the A (Add devices) opiion. The PC program 
will then search the system for all Protocol Convener device types and display ihis 
screen: 

PC BLOCK DEVICES FOUND: 

TYPE SLOT/PORT # 



RAMCARD NONE 

SmartPort 5 

Choose Interface by slot (0= Main menu): 



Had the program found a RamFactor card or an Apple IT Memory Expansion card, 
the memory card slot numbers(s) would be indicated also. When the desired slot 
number is entered, the program again displays the current device table, but prompts 
you to; 

Start installation at which drive? (A-F): 

The device specifiers (A:. B:, ...) assigned to a particular device type detcmiines the 
relative positioas of the other disk device lypes in the system. If one device type is 
installed as (he A: drive, it is inserted ahead of the current A: device, shifting all 
remaining devices in the device table. If die F: drive was a valid device, it would 
then "fail off" the end of the device table. For instance, by installing a Protocol 
Converter device as the A: drive, the slot 6, drives 1 and 2 disks become the B: and 
C: drives, and so on- 

If a new device is added to the device table list at a point other than die fir^l device 
in a sequence of device types, the new device (or devices) will overlay the 
remaininglistof devices, unlit a different device type is encountered. Put another 
way: if a new device splits a device type hsl, the subsequent devices of the same 
type in that type list are inactivated. For this reason, you should insert new devices 
only at the beginning of a list of a given device type, so that the remaining devices 
of [hat type will be shifted radier than deactivated. 
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Note to MegDrive usera: When the MEGDRIVE program is 
executed, it actually creates its own device driver and docs not 
need to be included as a valid device. Be carcful, when installing 
a MegDrive, to make sure that the MegDrive device specifier does 
not conflicl widi a cum;nt valid device. 

After a Protocol Convener type of device has been inserted into the device table, 
this prompi will be displayed: 



UNIT # DEVICE NAME SIZE IN K 
1 DISK 3.5 SDO 

Enter # oT devices to install (Maximuin = 1): 



The maximum number ofdcvices allowed isdeiemiinedby the tjpcandnumbcrof 
devices attached to the Protocol Converter bus. For example, two daisy-chained 
Protocol Converter drives would allow installation of two devices (e.g. A second 
UniDisk 3,5 drive connected to the output of the first drive), 

The updated conHguraiion is indicated by the new device table display. 
Configuration for any additional Protocol Convener devices can be done at this 
lime by rcsclccting the A option from the option menu. Once all Protocol 
Converterdcviccshavcbccnaddcd to die system, use the S option to set the LAST 
valid device in the system. Setting the last valid drive assures an error message 
will be generated by the operating system if an invalid drive is specified. 

The operating system in memory is now configured to support the devices shown 
on the device table. The next step is to save this configuration to the appropriate 
disk. This is accomplished by pressing the spacebar or Rerum key at the PC.COM 
"Choose action" prompt. If a Protocol Converter device was installed as the A: 
device, you will be allowed to write the CP/AM 5,1 operating system to the new A: 
drive. The default system installation file is CPAM60UF.COM, but the video 
driver to be installed is determined by the video driver in use by the operating 
system in memory. 

Reminder: The CP/AM disk that is supplied is full. You will need 
to ERAse some of the uriiiiy programs froni your backup to 
make room for saving your configuration, ERAse enough to free at 
least I5K. 

The configuration shown in die device table can be saved to a configuration file on 
a disk. CAUT0.COM is the default name for the configuration command file. 
This command fdename is automatically executed as pan of the system disk boot 
sequence. You can use the PC utility to create different configuration files under 
different command filenames, boot a generic (not configured) operating system, 
then manually execute a specific command for a specific configuration. 
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IMPORTANT: If ihe physical conngurdiioti of ihe system is ever 
changed in any way, Ihe configuraiion file will also have to be 
updated, 

Non-Standard //c The CP/AM operating system uses the default Product Identification Numbers 
Printer Port (PIN) for output to ilie primer port (LST; device) and communications port (PUN; 

Configuration and RDR:.) Each lime the //c is turned on» the following Product Idcmificaiion 

Numbers are in effect for serial ports I and 2: 

PORT UDcfaulOProducUdeniiricaiion Number 166/1124 

(1) Printer mode 

(6) B Data bitsy2 Slop bits 

(6) 9600 baud (bits per second) 

(1) No parity 

0) No echo of ouipui to screen 

(2) Insert line feed after carnage return 

(4) Insen carriage reium after 80 characters 

FORT 2 (DefauU) Product Identification Number 152/1 12 1 

(2) Communications mode 

(5) 8 Daiabas/1 siopbii 

(2) 300 baud (b\\s per second) 
(1) No parity 

(1) No echo of output lo screen 

(2) Insert line feed after carriage return 
(1) Do noi insert carriage return 

If your printer or communicafions device docs not work property with Ihe dcfaull 
PIN, use the Apple //c System Utilities disk lo reconfigure the PIN, The 
instructions for changing Ihc PIN arc in the Apple //c Owner's Manual or the Apple 
//c Sysiem Utililies manual. 

If you are required lo use a non-default PIN setting, you must boot the properly 
configured Apple //c System Utilities disk prior lo booting inio ihe CP/AM 
operating system. Remember, a warm booi (Con irol-0 -Reset or PR#6) will not 
erase the PIN currently in effecL A cold boot (power-orf/fxjwer-on) will reset the 
PIN to ihe default setting. 
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CP/AM 4.0B for CP/AM 5.1 requires a! least 64K of Random Access Memory (RAM) and an 80 
48K Computers column display capability. For computers with only 4RK of RAM or for systems 

with only 40 column capability, a 44K version oflhe CP/AM 4.0B operating 
system has been provided onihe backside oflhe CP/AM 5.1 System Master disk. 

Note: If you have a 64K computer without 80 column capability, 
you can use CP/AM 60K in the utihties menu. It has all the 
features of 5.1 but does not require 80 columns. 

Warning: Make a backup copy of both sides of the CP/AM 5.1 
System Master. The back side is specially partitioned lo contain 
both DOS 3.3 files and CP/AM files. Writing any data to the 
original disk may destroy its contents. 

Certain utility programs (iransiem commands) provided on the from side of the 
System Master will not work under CP/AM 4.0B. Compatible versions of some of 
these utilities have been included on (he CP/AM 4.0B side of the System Master 
disk. 

CP/AM 5.1 CP/AM 4.0B 

60K Command 44K Command 

AUTORUN AUT0RUN4 

FORMAT F0RMAT4 

CONFIGIO C0NKG4 

COPY C0PY4 

FMTUNl, AUTOPC. and RAMBOOT wiU work only with the 5-1 version; they 
will not work with the 4.0 version, 

To create a bootable CP/AM 4.0B System Master, use the F0RMAT4 command to 
fomiai a blank CP/AM disk. Then, execute the CPAM44K command to install the 
44K version of CP/AM 4. OB operating system onto the boot tracks of the disk. 
Boot the new system disk and Lnsen a copy of the CP/AM 5.1 System Master in the 
B: drive, Specify B: as the current drive and use PIP to copy ihe desired command 
files, (No second drive? Use die PIP [J] parameter.) 



What's Next.,. Unless you are an eitperienced Z-80 assembly language programmer, you're diroughl 
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Important! 



This section is intended for Z'80 machine language pragrammers only! All others 
should stay away or risk mental meildown. The lechnical information atwut 
CP/AM 5, \ contained in this section is provided specifically for those programmers 
using CP/M program development tools. (These tools are not provided with the 
CP/AM 5,1 System Master disk.) 



CONFIGIO 



Configure tnput^Output Paramelera 

This command ulihiy allows the advanced CP/M machine language programmer to 
reconfigure Ihc CP/AM operating system by redefining selected operating system 
parameters. The screen function definitions can be modified, keyboard characters 
can be redefined, and user specified system 1/0 driven; can be installed. All values, 
displayed and input, an: in hexadecimal notation. CONFIGIO menu options I. 2, 
and 3 modify the parameters of die operadng system currently in memory. Option 4 
allows the current operating system I/O configuration block to be written to (or read 
horn) a CP/AM system file on disk. 



Menu Option 1 Configure CP/AM Terminal Emulation. The Terminal Screen Function 
Dcrmition screen displays the current software and hardware screen function 
definiiioas. The CP/AM 5.1 Operating System is initially configured loemulaie the 
SOROCIQ 120/ IQ I40ienninalsand, if changed, can be reset to this default by 
selecting option M. 

The software definition column specifics the hexadecimal character siring required 
of the program to accomphsh the desired screen funcfion. The hardware definition 
columnspccrriesihecharaciersequences, issued by the operating system, to be sent 
to ihe tciminal upon receipt of the software definition sequences. The Lead-in 
character option allows Ihe lead-in character to be specified for all screen functions 
requiring a lead-in character. The XY Coordinate Offset option and the XY 
Transmit Order option are used in combinafion to cslabhsh the operating system 
cursor coordinate proiocoK Table 4-3 provides the memory locations associated 
with the Screen Function Definiiioa^- 



MenuOplion2 Redefine Keyboard Charaeters. This configurafion option was originally 
designed for eariier Apple 11 computers which did not have all the keys nccessaiy to 
mn CP/M software. While this is of little use to Apple //c and //e users, up to six 
keyboard characters can be redefined. As the initial default, there are no keys 
redefined. Tabic 4-2 contains the memory locations associated with the original 
keyboard character and the redefmed character 
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Menu Option 3 Load User I/O Drivers. Using this option, special user-written system 1/0 
driver nics can be loaded into the operating system currcnUy in memoQ'. Please 
refer to the paragraph enlitlcd "Custom CP/AMlnpur/Oulput Drivers," for examples 
and details on the pmpcr file fonnat 

MenuOpt]on4 Read/Write I/O Conflguralton Block. This oprion allows the current 
operating system configuration block to t>c wriiien to the CP/AM system file of a 
floppy disk. It also allows the conriguration block to be n?ad from a floppy disk's 
system file. 



Table 4-1: Z-80 / 65C02 Memory Address Translalion 

This table provides the corresponding memory maps 
for the Z-80 and 65C02 processors. 



2-80 ADDRESS 


65C02 ADDRESS 


OOOOH-Ot-t^FH 


SIOOO-SIFFF 


lOOOH-lhhFH 


S20O0'$2FFh 


2000H2t-FFH 


S30O0-$3hhF 


3000H-3FFFH 


S4000'$4ht-h 


4OO0H-4t-FhH 


$5O0CI-$5hhi- 


5OO0H-5FFhH 


$6000-S6hhF 


6000H-6hFhH 


$7(K)0-$7Ft-F 


7000H'7hFFH 


$8000-S8FFF 


8000H-BFFFH 


S9000-$9Ft-F 


9D00H'9FFFH 


$AO(X}-$At-FF 


AOOOH-Al-t-FH 


SBOOO-SBFhF 


BOOOH-BFHFH 


SDOOO-SDFFF 


COOOH-Ct-t-FH 


$E00O-$EhFF 


DOOOH-DhFFH 


$FO0O-$FFFF 


EOOOH-EhFhH 


$COO0-$CFFF 


FOOOH-Ft-FFH 


$0000-$OFFF 



Table4-2: Keyboard RedeDnilions 



Compared Character 


Redefined Character 


Location 


I^ocation 


F3ACH 


F3ADH 


F3AEH 


F3AFH 


F3B0H 


F3BIH 


F3B2H 


F3B3H 


F3B4H 


F3B5H 


F3B6H 


F3B7H 
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Table 4-3: Screen Function Definilions 



Soflwarc Hardware 
F396H F3A1H 



F397H 



F3A2H 



Description 

The cursor coordinate offset is contained in the least 
significant 7 bits (0-6) of ihis byte- The most 
significant bit (7) is Iheiransmii order of the X and Y 
coordinates. If bit 7 is zero tlie Y coordinate is 
transmitled firet. If it is a one, the X coordinate is first. 
Lead-in character. Zero if no lead-in. 



Note: In following byies, the most significant bit (7) specifies that 
a lead'in character is required for the given function. Bits 0-6 
contain the character thai corresponds to tliat particular function. A 
byte value of zero indicates the given funt;tion is disabled. 



F398H 


F3A3H 


Clear screen 


F399H 


F3A4H 


Clear to end of page 


F39AH 


F3A5H 


Clear to end of line 


F39BH 


F3ASH 


Nomial text 


F39CH 


F3A7H 


Invcree text 


F39DH 


F3ABH 


Home cursor 


F39EH 


F3A9H 


Address cursor 


F39FH 


F3AAH 


Move up one line 


F3A0H 


F3ABH 


Non-desif\icdveIy move cursor forwaid 



Cusfom CP/AM The following is the I/O driver file formal required by CONFIGIO: 
Inpul/Oulput Drivers 



Byie: 
1 
2 
3 
4 
S 
6 



Number of custom drivers contained in this file 
LS OcasL significant) byte of destination address of subroutine code 
MS (most significanl) byte of destination address of subroutine code 
LS byle length of subroutine code 
MS byte length of subroutine code 
Driver type {lor 2) 
Type 1 (Unchained drivers) 

7 yo vecior number to be modified (see Table 44) 

8 LS byte of address to be placed into I/O vector defined in byte 7 

9 MS byte of address to be placed into I/O vector defined in byte 7 
Type 2 (Chained drivers) 

7 1/0 vector number to be modified (see I/O Vector table) 

S LS byte of address to which the current contents of I/O vector 

mdicaied in byle 7 is to be loaded 
9 MS byte of address to which the current contents of I/O vector 

mdicaied in hylc 7 is to be loaded 
A,..n Driver object code, the length of which is specified by bytes 4 & 5 

n+1 Beginning of the next custom driver 
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TabJe4-4: In pu I/O ut put Vectors 



Vector Vector Vector 
Number Address Name 



0F38OH Console Status 



0F382H 
0F384H 



Console Input #1 
Console Input #2 



4 0F386H Console Output #1 

5 0F388H Console Outpm #2 



Description 

Rclums OFFH in register A if a character 
is ready to read and OOH if otherwise. 
Read a character from the console into the 
A rcgister 

Sends a character in register C !o Uie 
console device. Register B contains zero 
ifa standard charactcror if sending out a 
screen function command it contains the 
screen funcdon number. 



e OF38AH Reader Input #1 

7 OF38CH Reader Input #2 

8 OF38EH Punch Output #1 
OF390H Punch Output #2 

A 0F392H List Output #1 

B 0F394H List Output #2 



Reads a character from IIk readerdevice 
(Slot 2) into regislcr A. 

Sends the character in rcgister Clothe 9 
punch device (Slot 2). 

Sends the character in rcgister C to the 
printer device (Slot 1)- 



Logical to Physical 
I/O Devices 



The CP/AM lOBYTE at location 0003H can be used to redirect the logical input 
and output devices to different I/O vector table locations. The lOBYTE has the 
following structure: 



LIST 


PUNCH 


READER 


CONSOLE 



^ Bit Positions 



Console field 

Console Input #1 and Console Output #1 

1 Console Inpul #1 and Console Output #1 

2 Readerinpulfll and List Output #1 

3 Console Input #2 and Console Output #2 

Reader held 

Coasole Input #1 

1 Coasole Input #1 

2 Readerlnput^l 

3 Reader Input #2 
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Punch field 



Console Output #1 

Punch Output #1 

Reader Input #2 (data is output through this vector) 

Punch Output #2 



List field 



Console Ou!pui#l 

1 Console Output #1 

2 List Output #1 

3 List Output #2 



The area within the CP/AM operating system, reserved for user installed device 
drivcrs> is located Trom F200H lo F37FH. Be awaru that the RAMDRIVE program 
uses the MO block area from F200H lo F2FFH, 

Here is an example of a device driver routine to remove line feed character: 



;List device driver, 

ORG lOOH 
ORIGIN EQU OF300H 
OFFSET EQU ORIGIN-START 



CB 


1 


DW 


OF300H 


DW 


PGMEND-START 


DB 2 




ce 


OAH 


DW 


OUTPUT+OFFSET+1 




conTcnis. 


DW 


START+OFFSET 



START: LD A.C 

CP OAH 
OUTPUT: CALL NZ.OOOOH 



RET 
END 



;Load subroutine at lOOR 
:Actua] origin of driver. 



;Numbcr of custom drivera. 

;Addrcss to load driver. 

; Length of driver code. 

iDrivcr patch type. 

:l/0 vcctoi" number. 

iAddrcss to store current vector 

;New I/O vector address. 

:Move output character to register A. 

;Chc[:k for Tine feed character. 

;If not line feed, send character to 

primer. 

; If line feed, not send to printer. 

Continue. 

;Retum to calling program. 



The object code for this driver would be: 

01 00 F3 07 00 02 OA 04 F3 00 F3 79 FE OA C4 00 00 C9 
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In (erupt 
Handling 



From the way thai the Z-80 card uses the DMA line lo deactivate the 6502, all 
interrupt processing must be handled by the 6502. To enable maskable interrupts, 
the IRQ solder pad on the Z-80 canJ must be connected; non-maskable interrupts 
are not available. If the tntenupt takes place when the 6502 is active, intcirupt 
handhng is done in the standard way. When the Z-SO is aciive, the following steps 
must be taken: 



1 . Save any registers that are desinDyed on die stack. 

2. Save the contents of the 6502 subroubne call address m case an interrupt 
has occurred during the preparation for a 6502 subroutine call. 

3. Set up the 6502 subroutine call address to SFF58, which is the address 
of a 6502 RTS instniclion in die Apple monitor ROM. 

4. Return control to die 6502 by writing to the slot address of the Z-80 
card. When the 6502 regains control it will immediately "see" ihe 
interrupt and jump lo its interrupt handling routine. Upon return from 
the interrupt routine, die 6502 will execute the RTS instruction and 
reactivate the Z-SO ihiDugh the call manager. 

5 . When the Z-80 is reactivated, restore Ihe previous 6502 subroutine call 
address. 

6. Restore all used Z-80 registers from the stack. 

7. Enable Z-80 inlenupls widi die El instruction. 

8. Return from Z-80 inlemipt routine widi RETl. 



SHIFT.MOD 



A sample I/O device driver Tde. SHIFT .MOD, is provided on the back side of the 
CP/AM 5.1 System Master disk. For Apple II or II Plus owners with the "one- 
wire" shift key modification, this device driver will allow lower case keyboard 
input. Also, die control-K character, required by die Wordstar program, will not be 
suppressed. Once diis driver is installed, shift-0 (zero) will hincLion as the shift- 
lock key. 

CONHGIO option 3 is used to load the SHIFr,MOD driver file from Uic disk in 
ihc A: drive. Option 4W can dicn be used to write the 1/0 configuration block to 
disk. The assembly language print file for this driver, including comments, is 
contained in Ihe text file SHIFTPRN. 



Calling 65C02 
Subroutines 



Address (65C02) of subroutine musi be placed in memory location F3D0H. 
Register contents required by the subrourinc can be placed in the Register Pass 
Table (see Table 4-5). Then die following two instructions must be executed: 

LD HL,(0F3DEH) 

LD {HL).A 

When die above instructions are executed> die Z-80 is temporarily disabled and die 
65C02 registers are loaded from die corresponding Z-SO memory locations in die 
register pass table. Upon completion of the 65CU2 subroutine, the contents of the 
register pass table will be the results, if any, of die subroutine. 
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Table 4-5: Register Pass Locations 



Z-SO 


65C02 


Address 


Address 


F045H 


I0&15 


F046H 


S0O46 


F047H 


$0047 


F048H 


$0048 


F049H 


$0049 


F3D0H 


$03D0 


F3DEH 


S03DE 



Description 

65C02 Aregisler. 
65C02 X register. 
65C02 Y register. 
65C02 P (siams) register. 
65C02 S (Slack) register 

65C02 subroutine address. 
2-80 Slot address. 



TTiis is a sample Z-80 call to a 6502 monitor subroutine to beep the Apple speaker 



;Z-80 subroutine to beep the Apple speaker 



Z80 

ASSIIB 
REG$A 
BEEP 

START: 



EQU 0F3DEH 

EQU 0F3D0H 

EQU OF045H 

EQU 0FF3AH 



:Z-80 address. 

:65C02 subroutine pointer. 

i65C02 Aregisler. 

:Addrcss of 65C02 subroutine. 



XOR A :acarthe A register, 

LD (REG$AJ,A ; Demonstration of parameter passing. 

LD HL.BEEP ;L^ad HL with address to be called, 

LD (A$SUB),HL ;Siore 65C02 subroutine pointer, 

LD HL.(Z80) ;Get Z-80 address. 

LD (HL),A -.Write lo Z-SO address. 



;65C02 subroutine executed and Z-80 reactivated. 

■ 

r 

RET Jletum from Z-SO subroutine. 

END 
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IlGS Users 



Apple IlGS Users 



Selling Ihe 
Control Panel 
Menu 



TJiosc using the Z-80 Plus in the llGS will need lo set Ihc Control Panel menu to 
run CP/AM. You should already be familiar with how !o change settings with the 
Comrol Panel. If you are noi. please refer lo "Appendix A" in your -4p/?/e//G5 
Owner's Guide. 



Note: You must set up the Control Panel before you run CP/AM. 
CP/AM docs not support interrupts. 

In the Control Panel menu, set the options as follows: 

Set "System Speed" to "Nornial/ 

Set the slot containing the Z-80 Plus to 'Tour Card/' 

If disk drives are connecicd to the SmanPon: 

- setsioi5to"SmanPort" for the 3,5 disk driveCs). 

- set 6 to "Disk Port" for a floppy disk daisy-chained to the back of a 3.5. 

-- If you are using a conux>lIcr card for the 5.25 drive(s), 
set slot 6 to "Your Card." 



Exit Ihe Control Panel by choosing the "Quit" option from the menu and you are 
ready to boot the CP/AM disk. 

Note: Ifyou are using a fioppy disk as your startup device and the 
following message appears: "NO A.E. Z-80 CARD FOUND." 
simply reboot by pressing CONTROL-COPEN APPLE)-RESET. 



RAM Disk Notes 



If a lies is set up for a RAM disk in the Control Panel menu, the RAM disk will 
show up as a RAMCARD attached to the SmanPon on ihe PC menu. 

The PC program will recognize up to four 3.5 disk drives daisy chained to the 
SmanPon and a maximum of 6 devices in all. These will be listed as A-F in the 
PC menu. 

If you want the RAM disk (RAMCARD) to be your stanup device, yoti must set the 
RAM disk as your stanup device in the IlGS Control Panel Menu then turn the 
power off and back on again. The message, "CHECK STARTUP DEVICE" will 
appear on the screen. Press. "Control -Reset" to get the cursor ,then type, "PR#n" 
(n=sloi # that will access your CP/AM di.sk). Now access your PC menu. The 
RAM disk will appear as device A: RAMCARD, 

If you do not want the RAM disk as a device, select the RAM Disk option from the 
Comrol Panel menu and set the RAM disk's memory allocation to 0. Turn the 
power off llien back on to initiate ihe new sellings. 



Refer to page 3 1 and following for more infomiation about the PC menu. 
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Using Wordstar with CP/AM 



CWS33X 



There are some versions of the Wordstar word processing program that may noi mn 
under the CP/AM operating system. This is due to the manner in which these 
versions identify Oie host Z-80 card. The CWS33X program wJU modify certain 
parameters within the CP/AM operating system in order to compensate for 
Wordstar's erroneous identification of die Apphed Engineering 2-80 card. This will 
also enable proper display of the inverse video portions of the Wordstar screen. 
The CWS33X modifications to the operating system in memory remain in effect 
until the operating system is rebooted. 



Use this configuration program only if your version of Wordstar does not mn 
properly, as CWS33X has one adverse effect on Wordstar: it will disable the 
Wordstar Apple-Function key feature. 

Important: When installing Wordstar, you will need to idendtify 
The Apphed Engineering Z-80 Plus canl as a standard Micro Soft 
Softcard. 



Automatic 
Execution 
of CWS33X 
and Wordstar 



The AUTORUN and SUBMIT commands and the STARTWS.SUB file on the 
CP/AM 5.1 System Master disk can be used to automatically execute CWS33X 
— 'then mn Wordstar To do Uiis you must fif^i create a Wordstar startup disk 
consisting of the Following files: 



CP/AM 5,1 System Master files: 

(The CP/AM 5.1 60K operating system.) 

CWS33X.COM 

SUBMIT.COM 

AUT0RUN.COM (or AUTOPC For UniDisk 3,5 or RamPactor) 

STARTWS.SUB (This file is on side two of the System Master disk.) 

Wordstar files: 

WS.COM 
WSOVLYl.OVR 

WSMSGS.OVR 

Boot the Wordstar startup disk and enter the following command line at the ''A>" 
prompt: 

A>AUTORl)N SUBMIT STARTWS<cr> 

Boot the Wordstar startup disk again, Voil&! Wordstar. For more information on 
customizing your own startup Hie. refer to SUBMIT and AUTORUN command 
descriptions in Chapter 2» Transient Commands. 



45 



Appendix B 



Wordstar and CP/AM 



Wordstar Video 
Displays 



Some versions of Wordstar may not display the lexl on the screen properly. The 
Wordstar edit screen should be displayed in nornial video Oight letters on a daik 
background) and the menus and help screens should be displayed in inverse video 
(light background with dark letters.) 

By using the CONFIGIO program, it is possible to permanently modify a copy of 
the CP/AM 5. \ operating system lo support the proper display of Wordstar inverse 
video screens. 

• Use the PIP program to copy the C0NFIG10.COM program from the CP/AM 
5. 1 System Master to the disk containing the CP/AM 5. 1 operating system you 
will be using with Wordstar, the "Wordstar system disk." (CONFIGIO is an 
acronym for CP/AM hiput/Output Configuration Piogram,) 

' Execute CONHGIO from the Wordstar system disk. (A>CONFlGIO<cr>) 

• Select option 1 <cr> (Configure CP/AM Temiinal Emulation) from the main 
menu, 

• Select option E <cr> (Lo-Lite Text) from the Terminal Screen Fimction 
Definitions menu. 

• Specify N <cf> to the pttimpt, "LEAD-IN CHARACTER REQUIRED fY/N7)." 

■ Enter: OF <cr> (zero F) for the CHARACTER CODE, 

■ Enter: H <cv> (hardware) 

• Seleci option F <cr> (Hi-Lite Text) from the Terminal Screen Function 
Definitions menu, 

• Specify N <cr> to the prompt. "LEAD-IN CHARACTER REQUIRED (Y/N?)/' 

• Enter: OE <cr> (zero E) for the CHARACFER CODE. 

• Enter H <cr> (hardware) 

- Select option X <cr> (EXIT) from the Terminal Screen Function Definitions 
menu. 

• Select option 4 <cr> (READ/WRITE 1/0 CONHGURATION BLOCK) from the 
main menu. 

• Specify W <ci> 10 die prompU ^'READ-WRITE-EXIT (R/W/X)?" 

■ Press return. (Your Wordstar system disk should already t>e in the A: drive.) 

■ Select option X <er> (EXIT) from the main menu. 



The CP/AM 5. 1 operating system on your Wordstar system disk is now modified to 
display nornial and inverse Wordstar video screens properly. 
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Sider Hard Disk Support 



TheinstaliaiionoftheCP/AMS.l opcradng system on ihc Sider hard disk is a three 
step procedure. Siep one involves ihc conhguraiion of ihe Sider's Main Menu 
program. Siep two deals with selling ihc CP/AM startup defaults and actually 
installing Uie operating system on ihc boot volume. Step ihree [nvolves copying the 
desired CP/AM command files lo ihe boot volume. 

Before You If you have not already done so, make a backup copy of both sides of the CP/AM 

Hegin... 5-1 System Masierdisk! Any disk dupHcahon program will work. Rcmcmbcrto 

store the originals in a safe place. 

Note: Side two (the backside) of the CP/AM 5.1 System Masier 
disk has been specially crealed to contain both DOS 3.3 files and 
CP/AM fdes. If you catalog ihe disk under ihe DOS 3.3 operaiing 
system, ihe DOS flics will be shown. Listing a directory under the 
CP/AM operaiing system will display ihe CP/AM files on ihe disk. 

Make sure the 2-SO Plus and Sider hard disk are properly installed in your 
computer. If you have any doubts, double check the installation procedure in the 
appropriate User's Manual. 

IMPORTANT: CP/AM 5,1 must be installed on ihe Sider hard 
disk and configured before using ihe PC, COM utiiily to establish 
Ihe system configuralion. Once the Sider's CP/AM startup defaults 
have been estabUshed. the PC (Protocol Convener) utility can be 
used lo rearrange the CP/AM device table to include devices which 
support Apple's Protocol Converter (i,e. UnJDisk 3,5, RamFactor, 
and [he Apple II Memory Expansion Card). 

Step h Configuring Ihe Sider Main Menu program. 

Start up from the Sider. Check the version number of ihe Main Menu program, 
shown in the upper right comer of Uie screen. If the version is 4,0 or later, skip ilie 
rest of this step and proceed to Step 2. Vereions prior lo 4.0 must be patched to 
recognize the CP/AM operating system. Version 4.0 already supports Apphed 
Engineering's CP/AM 5.1 operating system. 

Insert side two of the CP/AM 5.1 Syslcm Master disk in the slot 6. drive 1 disk 
drive. Select Sider Main Menu option 3. "BOOT INTO DOS." At the Applesoft 
BASIC prompl ( j ), type: 

RUN lNSTALL.CPAM,S6,Dl,<cr> 

When the configurarion is complete, the program will rctum to the Sider's Main 
Menu. Remove the configuration disk fmm the disk drive. 
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step 2. Selling the CP/AM Slartup DefauUs. 

Insert side one (frontside) of the CP/AM 5, 1 System Master disk in the Slot 6, 
Drive 1 disk drive. Selecl Sider Main Menu option 6, "Bool into Slot 6." Al the 
CP/AM prompt { > ) enter: 

APATCH12<ci> (see Toomolc) 

The following menu will appear on ihc screen: 

First C\qsh Peripherals 

Inslallation program for Applied Engineering CP/AM - 5.X 

Version 1_2 

(C) Copyright 1986 



1) Install with hard disk as A:, B:, C:, D: 

2) Install with hard disk as C:, D:, E:, F: 

3) Quit with no modifications made 

Select one of the above ==> 

Option I Choose this option if you wish to boot CP/AM as the A: volume each lime you 
seleci the "BOOT INTO CP/M" option from Ihc Sider Main Menu. The CP/AM 5.1 
operating system will be installed on the Sider's A: volume. Volumes B:, C:, and 
D: will be created as additional storage devices. Drives E: and F: are assigned lo the 
slot 6 floppy disk drives 1 and 2 rcspeciivcly, 

A: Sider boot device. CP/AM5.I Operating System, 

B: Sider CP/AM storage device. 

C: Sider CP/AM storage device. 

ID: Sider CP/AM storage device. 

E; Slot 6, Drive 1 {Disk II) CP/AM storage device. 

F: Slot 6, Drive 2 (Disk II) CP/AM storage device. 

Option 2 This option assigns the Sider boot volume, A:, to the Slot 6, Drive I floppy disk 
drive and creates additional storage devices, C:, D:, E:, and F: on the Sider Drive 
B: is assigned to Slot 6, Drive 2. By choosing this option, you must have a 
bootable CP/M disk in Drive A: 



A; Slot 6, Drive 1 boot device. 

B: Slot 6. Drive 2 CP/AM storage device. 

C: Sider CP/AM storage device. 

D: Sider CP/AM storage device. 

R Sider CP/AM storage device. 

F: Sider CP/AM storage device. 



•■APATCH12 is Applied Engineering's updated vereion (1,2) of First Class Peripheral's 
APATCH program. 
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After choosing either option and pressing Renjm, the program will display this 
pre>mpt: 

Enler Ihe line (0-127 chars) you wish lo execute whenever the 
operating sysLem is booted. 

Enter iJie desired command line and press rctum. Any allowable CP/AM command 
may be used. If no command line is to be executed, just press the Return key. 
After die command line is entered, die message, "PRESS RETURN TO RE-BOOT 
SYSTEM," will be displayed. Press Return and the program will re-bool the 
CP/AM 5. 1 operating system using die startup defaults you selected. 



.Step 3, Copying command Tiles to the boot drive. 

If opiion 2 was selected, only one Tile needs to be copied from the CP/AM 5. 1 
System Master to ihe A: (boot) volume. In order to return to Uie Sider Main Menu 
from CP/AM without having to completely reboot, the command file 
AEXIT-CQM must be preseni on the A: volume. 

If option 1 was selected, you may use the PIP command to copy files from die 
CP/AM 5,1 System Master lo the Sider's A: volume. Make sure to copy the file 
AEXIT.COM to die A: volume. 

Whenever you wish to exit the CP/AM environmeni and return to the Sider Main 
Menu, type: AEXIT<cr> ai the A> prompt. If you wish, AEXIT.COM can be 
renamed using die REN system command, 

IMPORTANT! If the configuration of the computer is ever 
changed in any way. such as adding* deleting, moving any 
peripheral cards, or mourning or dismounting any CP/AM 
volumes on the Sider. die operating system CP/AM startup 
defaults must be reset as described above. 



Note to MegDrive users: For users with an Applied Engineering 
RamWorks memory expansion card installed in their Apple //c. the 
MEGDRIVE.COM Tde will create an emulated disk drive using the extra 
memory on the RamWorics card. When creating a CP/AM MEGDRIVE, 
the MEGDRIVE command, when used without a drive specifier, emulates 
volume C:. To avoid conflicts with other devices, asign the MEGDRIVE 
an unused drive specifier. For example, the command, MEGDRIVE G:, 
will create an emulated volume G: or will change the specifier of your 
curreniMegDrive to Grand will not conflict wiih volumes A: through F:. 
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Further Reading 

Appendix D 



Furlhcr Rc.trling These books arc avilablc at most bookstores. 

Tlje CP/M Handbook by Rodney Zaks * 
Published by Sybcx Inc. 
2344 6lh Street. Dcpt, A 
Beikelcy. California 94710 
1-800-227-2346 

Iniroduciion lo Wordstar by Arthur Naiman * 
Published by Sybex Inc. 
2344 6lh Sircei. Depl, A 
BerkelyCaIifomia94710 
1-800-227-2346 

Microsoft BASIC * 
Published by Diliihium Press 
UOOOS.W, llUiSireet Suite E 
Bcavcrton> OR 97005 
(503)646-2713 

dBASE II users guide 
Published by Crcen/PrenUce-Hall 

Programming the Z-80 by Rodney Zaks 
Publisbed by Sybex Inc. 
2344 6th SirccLDcpL A 
Berkeley, California ^^710 
1-800-227-2346 

How 10 Gci Started Wiih CP/M by Carl Townsend 
Published by DiliUiium Press 
P.O. Box 606 
Bcavenon, Oregon 97005 

CP/M Assembly Language Programming by Ken Barbier 
Published by Prenticc-HaU> Inc. 
Englcwood Cliffs, New Jersey 07632 

Z-80 Programming and Interfacing 
Published by Howard Sams. inc. 
43(X) West 62nd Slreel 
Indianapolis, Indiana 46268 



♦Highly recommended 
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Notes 



